home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / pmmixer.zip / PMMIXER.DOC next >
Text File  |  1993-12-05  |  7KB  |  160 lines
  1. PMMIXER V2.0 - a mixer tool for the SoundBlaster Pro under OS/2 2.1 MMPM/2
  2. ==========================================================================
  3.  
  4.  
  5. *** BETA RELEASE--USE AT YOUR OWN RISK ***
  6.  
  7. CHANGES FROM PREVIOUS VERSION
  8. -----------------------------
  9. It appeared that this little utility was being used by about everyone
  10. that used a SoundBlaster Pro with other sound sources attached (such as
  11. an internal CD-ROM player). This was because the CD input cannot be
  12. operated with native MMPM/2 controls (blame Creative Labs!). In this
  13. specific type of usage, which was not foreseen by the author, it appeared
  14. irritating that the PMMIXER did not save its settings between sessions
  15. and that it was too friendly in accepting other programs' tinkering with
  16. the SB mixer. E.g., after a system sound, your CD player was mute again.
  17.  
  18. I added persistant sliders (using a PMMIXER.INI file) and an Agressive
  19. mode, in which the mixer explicitely updates the hardware every 1/10th
  20. of a second. This is crude, but what else could I do without an API
  21. to hook into?!?
  22.  
  23. I also added a command line parameter '-' that will startup the mixer
  24. as an icon. This works but is ugly, I know. Hey, I did this for YOU on
  25. my free Sunday afternoon!
  26.  
  27.  
  28. Future
  29. ------
  30. There is still much to be done. I will do all of this, but not before I
  31. receive feedback from YOU, especially about the Agressive mode.
  32. Throw in everything you want to see on this mixer. Just keep in mind
  33. that I want the thing to stay SIMPLE. Don't try to include word processing
  34. facilities and app launching in it, please. We already have enough
  35. overpowered "tiny" utilities.
  36.  
  37.  
  38. What is PMMIXER?
  39. ----------------
  40. PMMIXER is a PM program to access the internal mixer on the SoundBlaster Pro.
  41. It displays the look-alike of a normal mixing console, with sliders and
  42. pushbuttons to control the SoundBlaster Pro's mixer manually.
  43.  
  44.  
  45. What do I need to run PMMIXER?
  46. ------------------------------
  47. Naturally, you need a SoundBlaster Pro sound card. Again, be warned
  48. that OS/2 does not like this card to work on IRQ channel 7, because this IRQ
  49. is reserved for the LPT1 device. Put the SoundBlaster Pro on IRQ 5 or so.
  50. Since this is a beta version, there's no provision for SoundBlasters on
  51. other addresses than 0x220. Normally, there's no reason to set the card
  52. to another address, so it will probably work right away. IRQ and DMA
  53. is not used at all.
  54.  
  55.  
  56. How do I run PMMIXER?
  57. ---------------------
  58. To run PMMIXER just type 'START PMMIXER' at an OS/2 prompt, or double click
  59. on the file object for PMMIXER.EXE. You can also shadow the PMMIXER file
  60. object into a folder of your choice, to easily get to it, or create a real
  61. Program Object. By adding a '-' parameter after it (or in the PARAMETERS
  62. field), the mixer will start up minimised ('START PMMIXER -').
  63.  
  64. Be careful to start PMMIXER in the directory where you want the PMMIXER.INI
  65. file to be created (or to be found). You can include the default directory
  66. in the appropriate field of the Program Object.
  67.  
  68.  
  69. How do I work with PMMIXER?
  70. ---------------------------
  71. The program is pretty much self explanatory. The sliders control the volume
  72. levels for the various inputs and outputs of the SB Pro. The radio buttons
  73. control the recording source and whether or not certain filters are
  74. enabled. Play around while producing some music (e.g. by running TRACKER)
  75. and you'll figure out how it all works.
  76.  
  77. In the System Menu of the mixer (the little black-and-white mixer icon in the
  78. top-left corner of the window) I've added an About box choice that displays
  79. some information about version number and such (and wastes a few CPU cycles
  80. on you) plus a small Help choice that currently gives some beta information.
  81.  
  82. PMMIXER should not interfere with other programs that use the AMPMIX device or
  83. access the SoundBlaster directly. It will not, however, update itself as soon
  84. as the SoundBlaster settings are changed. The update will come as soon as you
  85. re-activate the mixer, e.g. by clicking on it.
  86.  
  87. On the other hand, if you switch to Agressive mode, PMMIXER *will*
  88. bluntly reset SB levels to what you told them to be every 1/10th of a
  89. second. This is to overrule %$#@@%$ MMPM/2 that thinks it knows better
  90. what you want than yourself (hey, it still is IBM, isn't it).
  91.  
  92.  
  93. What are the known bugs?
  94. ------------------------
  95. There are tons of them, but no one should really sit in the way. This is
  96. a test project and I want feedback on some of my approaches before going
  97. further.
  98.  
  99. The mixer is somewhat boneheaded in accepting the SoundBlaster's settings
  100. at startup. It will copy the sliders, but not the controls. This is something
  101. stupid in my code but not severe enough to delay the release of the beta.
  102. You might have to press some buttons before the sound is what you want.
  103.  
  104. Only the sliders are persistent yet. The rest will follow.
  105.  
  106. I did my best to code the PMMIXER display-independently. On my 1024*768*256
  107. screen it looks pretty neat. It might be that on other lower or higher 
  108. resolution screens some graphics are screwed up. If so, please notify me,
  109. so that I can change the program appropriately.
  110.  
  111.  
  112. Who else gets credit?
  113. ---------------------
  114. First, David Nichols (davidn@cs.tamu.edu) who wrote what is now version 1.0
  115. of PMMIXER. He did 70% of the job. I replaced the scroll bar controls with
  116. OS/2 2.x's new slider controls, added the About and Help boxes, converted
  117. the thing to use direct hardware access, and re-vamped the interface. 
  118. Since this was my first encounter with OS/2 PM programming, many thanks to
  119. David for implicitly teaching me how to do things.
  120.  
  121. Second, Michael Fulbright (msf@as.arizona.edu) for providing us OS/2 fanatics
  122. with a good SoundBlaster driver and some useful documentation on it. 
  123. Unfortunately for his ego, IBM decided not to buy his drivers.
  124.  
  125. Third, some people at IBM for giving birth to OS/2 2.x which is by far the
  126. nicest operating system for Intel-based computers that I've encountered
  127. so far.
  128.  
  129.  
  130. Are the sources available?
  131. --------------------------
  132. Of course they are. Just mail me (hoppie@kub.nl) and you'll get them.
  133. Since this is a beta release, code still is under development.
  134.  
  135.  
  136. What about MMPM/2?
  137. ------------------
  138. I would *love* to re-write this program to correctly control the Sound
  139. Blaster Pro through MMPM/2. However, Creative Labs decided to screw us
  140. and did a bad job on writing drivers. No mixer support at all.
  141. Hopefully they will learn quickly after having a good look at the
  142. Pro Audio Spectrum (PAS-16) drivers.
  143.  
  144.  
  145. DISCLAIMER
  146. ----------
  147. I (and probably David and Michael as well) take no responsibility whatsoever
  148. about the correct functioning of this program. It is provided for free
  149. to everyone who happens to like it and will cost $100 for others.
  150.  
  151. Having said this, I might try to adjust the program if someone kindly points
  152. me to a flaw or an improvement.
  153.  
  154.  
  155.  
  156.  
  157. December 5, 1993
  158. Jeroen Hoppenbrouwers (hoppie@kub.nl)
  159. Infolab, Tilburg University, The Netherlands
  160.